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Typographical Conventions Used in this Publication 

Bold facing indicates what you should type. 

Square brackets, [] , indicate a function key, the name of which appears 
in uppercase within the brackets. For example, [RETE^] , [CTRL], etc. 

Underlining is used for emphasis. 
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Information aix>ut this Manual 

Review the follcwing items before you read this publication. 

The subject of this manual 

This manual explains what the Zap program is, how to execute the Zap 
program, and hov to execute each function within the Zap program. 

13ie audience for whom this publication was written 

This manual is for the system manager or systems programmer who needs to 
edit files that contain binary data. Before you read this manual, you 
should complete the tutorials in either the MCS User's Introductory 
Manual or the MC& .§^st£m Manager's Introductory Manual. 

Related publications 

This manual describes a system utility. The Reader's Guide to WMCS 
Publications shows you the relation of this manual to other WMCS manuals. 
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Reader's Guide to WMCS Publications 

Instructions: Determine the audience to which you belong and 

then read only the publications at an arrowhead. 

Dotted arrowheads indicate optional reading. 
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Chapter 1 
General Information 



The Zap program, one of the utilities in the WMCS operating system, 
displays the contents of a file or device in hexadecimal format and 
allows you to edit any file on a disk or to examine iDut not change a file 
on a tape. 

Zap is particularly useful to the system manager or programmer who needs 
to edit files that contain binary data, such as executable files (i.e., 
files with a .EXE extension), directory files (i.e., files with a .DIR 
extension) , and certain system files. For example. Zap is the only 
program by which you can edit the files /ROOIDIR/FCB. SYS, /ROOODIR/ 
FCBBITMAP. SyS, and /RODTDIR/ BITMAP. SYS. Zap can also give you direct 
access to the physical sectors on a disk. 



The following illustration shews the relationship of the 
other programs on your system. 



Zap program to 




Other 

Editing 

Programs 



Text 
Files 



Binary 
Files 



The Zap program (like any other WMCS utility) is executed from the 
Command Interpreter Program (CIP) . In other words, each time you type 
the dP command mnemonic ZSQ. onto the CIP command line, you gain access 
to the Zap program. 
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General Information 



The functions explained in this nianual apply only after you execute the 
zap command. 

NOTE: Even though Zap is a very useful program, unless you knew precisely 
what you are doing you may destroy the means of retrieving a file 
(or the files within a particular directory and its 
subdirectories) . 



The Zap Program and Your Terminal Type 

The Zap program works with a variety of terminal types. You must tell 
Zap what type of terminal you are using so it can adapt the Zap program 
to. your particular type of terminal. 

To find out hew to set your terminal type, read the description of the 
DSTAT command in the JSMCS I2s£JLlja Reference i(&nual. For further 
information on terminal types, refer to the VHW User's Reference Manual . 
Zap uses the same terminal setup files as VEW. 



13cm to Execute the Zap Program from the CEP 

A summary of hew to execute the zac command, useful for quick reference, 
is provided in the MMC£ User ' s Reference Manual . A complete description 
of executing the Zap program from the CIP is given here. 



Command Line Syntax 



Mnemonic 


zap 






Required 
parameter 


Filename 






Switches 


:mask8bit 
: rewind 


:memory= 
: setupinF 


: readonly 
: setupout 
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General Information 



Parameters 



Filename 



Function 



Default 
Syntax 



Use this parameter to specify the name of the 
file or the name of the disk device you want to 
edit with Zap. 
None. 

Type a single, standard filename, or the name 
of a mounted disk device preceded by an 
underscore. Wildcard symbols are disalloved. 
If a tape file is specified, only the : readonly 
mode is allowed. 



Switches 



:mask8bit 


Function 




Default 




Syntax 


:memory= 


Function 




Default 




Syntax 


: readonly 


Function 



Default 
Syntax 



Use this switch to mask the high order or 

eighth bit for the text display of the file. 

The hexadecimal part of the display will not be 

affected. 

Do not mask the eighth bit. 

Type :mask8bit 

Use this switch to specify the amount of main 
memory (in kilobytes) to use as a buffer for 
holding modified pages while editing in Zap. 
32 Kilobytes. A value of means no limit 
other than available physical or logical 
memory. 

Type tinePBoryss followed by an integer between 
and 1000. 

Use this switch to prevent modification to your 
files or devices in Zap. If : readonly is 
specified, then when the file appears on your 
screen. Zap allows you to move the cursor in 
the file, but it does not allcw you to make any 
changes. A bell sounds if you try to type new 
characters or to use any modification commands. 
moreadonly. However, if you specify a tape 
file, the default is : readonly, 
lype : readonly 
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General Infonnation 



rewind 



: setupin= 



; setupout= 



Function Use this switch to rewind the tape device. 
Default rnorewind, i.e., the tape device begins at the 

current position instead of at the beginning of 

the tape. 
Syntax Type : rewind 

Function Use this switch to specify an alternate setup 
file to use for sys$input. If this name 
specifies a directory path, it will look in 
that directory for the setup file based on the 
terminal type. If this specifies an explicit 
file, it will use that file. 

Default Use the setup file in sys$disk/syslib. setup/ 
determined by the terminal type, e.g. , if your 
terminal is a T7000, then the file used will be 
sys $disk/sysl ib. setup/ setup252 . sys . 

Syntax Type :setupin= followed by a filename. 

Function Use this switch to specify an alternate setup 
file to use for sys$output. If this name 
specifies a directory path, it will look in 
that directory for the setup file based on the 
terminal type. If this specifies an explicit 
file, it will use that file. 

Default Use the setup file in sys$disk/syslib. setup/ 
determined by the terminal type, e.g., if your 
terminal is a 17000, then the file used will be 
sys $disk/sy si ib. setup/ setup252 . sys . 

Syntax Type :setupout= followed by a filename. 



Examples 



> zap ooiionand.doc 

This command allows you to examine or modify the most recent version of 
the file 00MMAND.DOC. 

> zap coinmand.doc : readonly 

This command is like the first example except it does not allow you to 
modify the file. 
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General Infonnation 



> zap .jntO/rootdir/fcb.caat 

Hiis command alleys you to examine but not modify the file /RDOIDIR/ 
FCB.DA.T on whatever tape is loaded in the device _MrO. Because the file 
is located on a tape device, the Zap program automatically uses the 
readonly mode. 

> zap _dxO 

This command allows you to examine or modify the physical sectors of the 
device JDXO. 



Notes on Usage 

If you use Zap to directly access physical sectors on a disk, as in the 
last example above, you must have the privileges READPHYS and WKETEPHYS. 
Refer to the W£2. S^staa ftenager's Reference ivfenual for information on 
process privileges and file protection. 



Related CIP commands 



dump Display the contents of a file in hexadecimal format 
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General Information 



Hie Zap Program and Your Terminal Screen 

When you type the zsel command and a filename onto the dP command line 
and strike [RETE^N] , your terminal screen looks like the following 
example. 




64 2B 

65 6X 
$6 74 77 

aD $$ 74 60 

mm6xn 
mm mm 



OA 54 €B 65 
73 65 2D 6f 
61 72 65 20 
65 72 6£ 65 



2D €6 69 72 
66 2S 74 6a 
77 60 6C6C 
74 2DCl^ 
SB MffiTZ 



74 mm mm 



nmizn 
mm7^m^ 



6SI712&CI 

m74^nm 

74m um 
m74 m m 

74 73 29 74 



74 T? 

71 mn m- 
mumm 

7$mmm, 
7zm^6$ 

r%wmm 

«r 01^57 4E» 

mmnm 

*S"9Q' vst 72t^- 



73 74 20 72 
6S 73 20 73 
20 75 73 65 
20 74 U 65 
€r 74 1^ 63 

74 6tir ^ 
tif^ ^611 €$> 

mM€im 

65 2Qr SuT 4Et 
6S 6t ir 72 
6t 65 72 2!> 
$t 61 <^63 
4S m 29 6t 
2& 41.20 6ft 

wm-7%--w 



ee&^.'Vbm first r 
^«tts« of this 

ci£tii»tr« will use 






CS S«D ar« ineor 
, xB|!ortmt e»ka»c 

<KMRStJI tCUfiQlCS i 

i!r«*'*jk»' A ft 

W0 < ff;^ ! ^% l< H r ^y 







The cursor, circled above, appears at the beginning of the file. 
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General Infonnation 



The Text F ield 



The right-hand column of the screen displays the printable ASCII 
(text) characters in the file. 



OOOOQOIO 



nmuTB 

«5 $C 65 61 
6F 66 74 77 
20 65 74 68 



0A 54 68 65 
73 6S 20 6r 
61 72 65 20 
65" 72 65 65 
64 77 6X72 

7$mmm 



69 72 
74 68 
6C6C 
6173 
78.72 

64 m 
mofm^ 'mM' nm «i^ it :7#7$ n 6& 7$ 2c 



20 66 
66 20 
77 65 
74 20 
65 20 
«164 



73 74 
69 73 
20 75 
20 74 

6F74 

74 6S 

6r72L 



20 72 
20 73 
73 65 
68 65 
6F 63 



m 6e 6f 7i 

4t 53; M 3i 



6Bt69 
75 67 

m73^mu.m€4^mm 6i6a6X6s 

€Km€g7Z 

72 20 

6t63 

20 69 

20 41 20 6S 

20 6S 73 20 



73 74 €1 $E 






mm 
mm 

2$ 2» 4r 74 
74 20 61 ^ 



0X^57 4D 
Of 31^ 



6a 6X 
43 S3 



sei^.-The first r 

elease of this s 

oftware will use 

ethemet as the 

.hardware pro toe 

^ ol . . . In addition 

' to the networki 

-ng features, bug 

', fixes and enhan 

' cenients. since WH 

'. CS 5.0 are incxir 

; porated. Other 

; ijnportant enhanc 

\ ements to.WMCS i 

;nclude:...l. A n 

~ ew scheduler is 



msM mm ,.jmmj}e^<amB^mmm!m$mjtmM' 




This column is the text field of the display. The text field is 16 
characters wide. If a character in the file is not printable, such 
as a tab character or line feed, a period appears in its place in 
the text field. 
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General Infonnation 



The,Hexa<^eciP\9l Field 



The four columns in the center of the screen display the hexadeciinal 
values for the characters in the text field. 



ooooooio 

00000620 
(HiOQ0030 



73 65 
65 6C 
6F 66 
20 65 
|0A 68 
tSF 6C 
1 20 74 
>|6E 67 
1 20 66 
J 63 65 
143 53 
0a00Q08GH70 6F 

oocioaocr|69 6d 

165 6D 
16E 63 
165 77 



64 2E 

65 61 
74 77 
74 68 
61 72 
2E OA 
6F 20 
20 66 

69 78 
6D 65 
20 35 
72 61 

70 6F 
65 6E 
6C 75 
20 73 



OA 54 

73 65 
61 72 
65 72 

64 77 
OA 49 

74 68 

65 61 
65 73 
6E 74 
2E 30 
74 65 
72 74 
74 73 
64 65 
63 68 



68 65 
20 6F 
65 20 
6E 65 
61 72 
6E 20 
65 20 
74 75 
20 61 
73 OA 
20 61 

64 2E 
61 6E 
20 74 
3A OA 

65 64 



20 66 
66 20 
77 69 
74 20 
65 20 
61 64 
6E 65 

72 65 
6E 64 

73 69 
72 65 
20 20 

74 20 
6F OA 
OA 09 

75 6C 



69 72 
74 68 
6C 6C 
61 73 

70 72 

64 69 
74 77 
73 2C 
20 65 
6E 63 
20 69 
4F 74 

65 6E 
57 4D 
31 2E 
65 72 



73 74 
69 73 
20 75 
20 74 
6F 74 

74 69 
6F 72 
20 62 
6E 68 
65 20 
6E 63 
68 65 
68 61 
43 53 
20 41 
20 69 




20 72 
20 73 
73 65 
68 65 
6F 63 
6F 6E; 
6B 69 
75 67 
61 6E 
57 4D 
6F 72 

72 20 
6E 63 
20 69 
20 6E 

73 20 



s6d**lbft first r 
eleasHfr c£ this s 
oftvarewill use 

ethez7»t as the 
•hardtttre ptotoc 
c^««»3Eti a(3dition 

to tho Dfttwoclei 

fixm.aso& tshmi 
o0nMtttfc0»slnc6 wi 
GS 5.0 9X9 Inoor 
poratadL QHmt 

cRontd tQ.OfCS i 
nclodfts.*.!. An 



'A*^..X*4^ *■ / /4i ■. 



These columns make up the hexadecimal ilifixL field, of the display. 
For example, the 73 in the first position on the first line of the 
hex field is the hexadecimal equivalent of lowercase s, which you 
find in the corresponding position of the text field. The OA in the 
fifth position on the first line of the hex field is the hexadecimal 
equivalent of the line- feed character, which is represented as a 
period in the corresponding position of the text field. 

When you type or change a value in the hex field. Zap changes the 
corresponding character in the text field. Conversely, when you 
type or change a character in the text field. Zap changes the 
corresponding value in the hex field. Therefore, you can use Zap to 
edit either field. 



Each hexadecimal value 
file. 



in the hex field represents one byte in the 
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General Information 



Byte Addresses 



The left-hand column of the screoi displays the eight-digit address 
of the first byte in each line. 



fled*.1Sie first t 

4al6ase of ^ids s 

eftsrare will \3m 

etiiemet sa Urn 

ng fyu^bisc^p bug 

f!t iai fi[ti'ii»fHr»n ft tH 
CS S*0 mm ixxxxc 



00000000 


73 65 U 2& 


OA 54 68 65 


20 66 69 72 


73 74 20 72 


00000010 


65 6C 65 61 


73 65 20 6r 


66 20 74 68 


69 73 20 73 


00000020 


6P 66 74 77 


61 72 65 20 


77 6»6C6C 


20 75 73 65 


00000030 


20 65 74 68 


65 72 6S 65 


74 20 61 73 


20 74 68 65 


00000040 


OA 6« 61 7a 


64 77 61 7a 


65 20 70 72 


^ 74 61? 63 


00000050 


6F6C2E(III. 


aA4i6s:^ 


61 64 64 6S^ 


74 6» ^ 6S 


00000060 


23 74ai2S 


ummm 


mm 74 77 


m72m$» 


00000070 


616T3Sr66^ 


mt^nw 


7a6S7tae 


2^Ct7f 67 


00000080 


2amm79^ 


mn-mm. 


mumm 


m$&$Lm 


00000090 


63 6$ 6I> 1^ 


my^nmn^^n 


m 38^57 40^ 


OOOOOOAO 


43 sataeasr 


MZH^WU 


7zmm€§ 


mm&^Tt 


OOOOOOBO 


78 6F7aCl 


74 mum 


29S m 4r 74 


mmTzm 


OOOOOOCO 


69 6& 70 i» 


num.m 


74 ao ^ 6i 


6S61 6KS3^ 


OOOOOODO 


6$ 6D 6$ 6B 


7* 7t m 74 


»msr m 


43 B 20 69 


OOOOOOEO 


6E63 6C7S 


ummm 


Oft. OS mm 


aO 41 aO 6E 


OOOOOOFO 


65 77 ap 75 


mmrnu 


7f 6C^73r 


m$»7^n 










The numbers are for your convenience in keeping track of your 
position in the file. Ihey represent the relative byte position, 
within the file, of the first hex value or character (i.e., the 
first byte) on each line. In the foregoing sample file, the 65 in 
the first position on the second line is byte number 10, the 6C is 
byte number 11, and so on to the 73 at the end of the line, which is 
byte number IF in the file. 
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General Infonnation 



Page Numbers 



The page numbers at the bottom of the screen are assigned by Zap for 
your convenience in moving about the file. 



ocooaoio 

00000020 
00000030^ 






mm mm 

72 6S 20 €F 
OA 4» dB 20 



■ -mm-m^im 

61 64 64 69 

68 65 74 77 



::71?:7412ai:7iM 
.■6iv73::20::^l3i; 

.:6i?':74j'61?Sif: 
74 69 6F 6£ 
6r 72 6B 69 



■memmmmimm^m^m^&^^M^^mmmm^Km 



immmm 



74 65 64 ^ 

ammmtm 



mmmmm 
immmm 

0AO9U2B 
75 fiC 65 72 



65 29 57 4> 
61 63 6F 72 

6S 65 72 20 

43 5} 20 69 
20 41 20 6S 
20 69 73 20 









.fMiiiilliiiiiili^^ 

IPage : 00000000 V:; 



■d^^^M^^^^^^^MmsmiM^mmM^m^^^M^^^^^^^^mmmmmmmm. 



Sixteen lines constitute one page (screenful) of data in Zap. Page 
numbers are given in both hexadecimal and decimal forms, 
respectively. For example, the first page in a file is 00000000 in 
the hexadecimal system, in the decimal. Ilie second is 00000001 
and 1; the tenth, OOOOOOOA and 10; and so on. 
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General Information 



The Filename 



The File Name entry at the bottom of the screen indicates 
complete pathname for the file you are editing. 



the 



omomm 
mmtmo 



73 65 64 2B 
65 6C 55 ei 
6F « 74 77 
^ 6S 74 60 
(Hk 68 61 72 

mmum 
m 7# cr m^ 

mm m-m- 



QQcmxa mm "mm 



OA 54 6& 65 
73 65 20 61' 
6172 65 20 
65 72 6E 65 






20 66 6d 72 
^ 20 74 66 
77 6»6C6C 
74 20 61 73 
^^711 7a 



73 74 
6S73 
20 75 
1^ 74 
«r74 6P63 

74 mm 61 

m n mm 

n ^ 75 67 



20 72 
20 73 
73 65 
66 65 






74 mm :m 
7$ 74 mm 

74 7% m 74 

ummm 




mm 
mm 



74Mmm 6»61 

m^ MM- ^'41 

,7!^', vEJL 65^ 7%. 



72 n 

6S63 
20 6$ 



2&6»73 20 



;File Name: _WEESJ}S0/aRAl!G.BETA/MCS0600.BLS.14 



Q£t(«eu»» idUl use 



C0 5*0 iKt<^ Ino&t 



n cSt t> l>i >-«n»X*^ -Hi. xk 
tit 8dbodEia3>Mt 4fli 



-- S(r'!?0^i^M^^m. 




^litw^-^ X .« iima<mtii.j<ii»»iii' 'ii j wiiiw < ia»' ift < i ftfen 'ii ji^iiiJh^^fciiMiKa te t iit ia y iM tM* ^ j.»oj»>«^o' .ii>iA^a^<^:i<fcii.«iAo>*i(.4»>8i4i.g~>g>>-i^..^»^-»->; 
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General Infonnation 



If the file is new, your terminal screen looks like the following 
example. 



OOQOOOOO 


tX.XX;;:XXim: 


3m XX:'.XX:'XXi:': 


XK^)m^'Xmiim;. 


■:ii;^:»i;-xiixii 


:■.: -i!:*:.!*.:**?.*.*:.** *:«;♦:.»..» ♦■wl 


OOOOOOID 


xm^xmi:xmxm. 


.XX:. XX. XXi'.XX::... 


..'XX..XX^XX::'XX:^'^ 


:itx:xx.:)aE:::Xxo'- 




00000020 


'xm:xit.:m.)m:. 


XX:'.XX:XX::''3aE;:t 


■■XX;XX:.-.XX:;.XXt 


..XXiXXfXX:. XX;..; 




00000030 


■:7m^:imym^xxm 


;XX:::.XX: XX.,XX- 


;XX:;XX:>'XX:.jai|. 


VXXf'XXrXX:' XX:"".' 


...■ .#.■#.*.•::♦.,». i:. «■.*.♦:«.■♦,;♦.*:♦ ft.. 


00000040 


-^wi^i0>;m}tm. 


■..xx:-jpi:;-xxii-xx5 


:'XX'.XX:f.XC19Qe:;:C 


lXX;.XX:r::XX.:XX::.:' 


■;.♦.♦:«*;».♦ *..«.«.i«..l((.« «. •;.» «,. 


00000050 


XX XX Xft xx 


:X3EE'.XXi:XK$:"XX:': 
XX XX XX XX 


^'3Di:.|Si:::XXi:XX:| 

:;:|ei5?jE§;:Xii|3|i^^^ 


;.;xg-:.XXfXX;xX:::;^- 




000000^ 


;; ■; .♦>«:«s»;*.#.«.<|>..»j** ;V: •:.* ■»;»■ 


mmomfi^ 


XX XX XX XX. 


XX XX XX XX 


!:;i^'W^/.;|: WiflR;- ';*(PlflPfei'-:#liifli^;: 


lIBJIii'XXs'XX^XXI::;' 


:;:.;'#:!w.i|tt«;»i«^:.«<#;;4^:.t,:*<:.ii^^ 


Qmimm 


XS XX XX XX 


;i?P^:i^^iii^fSii:iP?i|j 


XX XX XX. XX 


lllllgllPI;:^::;;; 


:j|4^it^:P#^^<^:4!i#ii«i)k#>*:«:^:: 


OQ00O0S& 


XX XX XX XX 


XX XX XX. XX 


iiiillliililiiiii^^ii^ 


liiliSi?ii|:;:XXi:: 


:i;|||»5i^;^;i:%j^Sfe^*^ 


00(826010 


XX XX: XX XX.' 


XX XX XX XX 


XX XX XX XX 


XX XX XX XX 


|;:|^;«:*!ip5i»:*^^ 


ooooooso 


t0l^^§)^0i^iOM 


XX XX' XX XX 


liiiliiliiiiii^ 


iiiiieisioi-iBi:i 


f:'ijMKs|:fcii^^ 


Q&mom 


XX XX XX XX 


tMl^^KS^M^'MM 


XX XX XX XX 


XX XX XX XX 


j; -piiii !^:<!l«;4i»iMiii*:iiiK»!<fe 


ixmoom 


f0lf^3^f^$QI^0l^ 


^wmemxi:: 


^:;;Xllii:Pi|3i||f|ili 


iXillXX^lil':; XXo ' ; 


V.«.;il>»;«:»:»:»i(i::»:.)fe<t^;<»:«i*:ij 


oooooom 


;';PiiXli|;'3di|:;'XXi 


)0^ia$;^:$a0i. 


XX XX XX XX 


liai::ii;xx-.xx::,:' 


.:;V«:»#«:*4t:.*:#«S;#tj«i<^:»#:<K;«^ 


00000080 


XX XX XX XX 


iP^^klil^^pxi^xili 


''9Ryi^'''3PlP'^'3l3|^:'^1)GJi^'^' 


;ii::xxixxi:xxc::: 


■■ ^:.«S**:#.#i«;.«:*:«!*:«»S.».*.»i 



;io;#'iiiiii":::psiL^^ 








Whenever you are editing a file and there is no more data in the 
file, the rest of the hexadecimal display for the page is filled 
with lowercase x characters to indicate that there is no valid data 
from that point on in the file. 
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General Infonnation 



Editing a DisK DgVJge 



If you are directly editing a disk device. Zap displays sector 
numbers in addition to page numbers f as in the following example. 



oooooooa 


7Z SS64 2S 


OA 54 6a 65: 


Turn. 69 TZ 


71 74 2D 72 


ooQoooia 


65 6C 65 61 


73i65 2a6F 


mmmem 


69^ 73 20 73 


ommm 


6F 66 74 77 


62.72 65 201 


77 &^m. er 


20 75 73 65 


0000003^ 


20 65 74 6a 


,6Sli 72^.61= 


74^::-2a^63fc-73P-- 


20 74 6a 65 


0000004Ct 


Qik6&61 72 


^m^-mm-m:: 


^m^Tmim^mi 


6^ 74 6F Sa 


ooonoom 


6r6cmait 


■■Qmm,&m2m; 


.miSmm^:^ 


74 69!6P6E 


OOOOOO$0 


ar 74 6ar 2QI 


wmim^m$i 


im.mmmmi 


6r72 6a.«^ 


0OO0Q87(r 


6S$7 2il66r 


tmm'mimi 


^^m^mm'Tm 


20rK|-75«7' 


QGSQOlOdOt 


2(1 60 6» 7r 


^^$mm^mm'^ 


-'0m^m2m.&M 


SESS-^^B^ 


(Kiaooosd 


6^6S6DI6S 


im'rm^mfm:: 


''■'m<&^m-m;.. 


mmsr m 


mQQOom 


4^^21115^ 


92m^m-2mm^^ 


i^m^mTmm^ 


6E63 6F72 


OOOQQOBd 


7(1 Sr 72: fit 


:i7m<sm&i$:2m 


^imm^mmm 


6S €5 72 2{r 


00{ffi08C0t> 


^6D^7(r€r 


-m^irnm^^ 


^'m.'mM^fsm 


69 61 $S 6a 




6!f (X^ 6S' 6]E^ 


i^7^;7S'2li^T^:^: 


'^.'SS^tSB^^'AE^: 


43". 53^- 21 6<^ 


oofmcm 


6E6^6C?S 


'^:m€m^2m(m^ 


':tm^mm^ 


7m^m^s&^ 


QOOOOOFOr 


6»-7T'a»7^- 


'^.mmm^sm^. 


immmM 


mmnt^m 



Device Name: ^EEHJDSO 
Sector : 00000000 
Page : 



sed»*.IfiBe; first, t 
eieaaes' (^: thiS: m 

' .b«edMftr«'.pcot(xr:' 



'^iiiis^i^ii^iii^^i^^iii^tiiii^z^^^^-i 



The sector and page numbers are displayed in hexadecimal form only. 

Note that instead of a filename. Zap displays the devicename when 
you are editing a device. 

The page number is not for the number of pages from the beginning of 
the disk; it is the page number in the sector you are editing. The 
number of pages per sector is is determined by the sector size of 
the disk, divided by 256. For example, disks with 512-byte sectors 
have 2 pages per sector; disks with 1024-byte sectors have 4 pages 
per sector. 

The byte addresses for a device are relative to the beginning of the 
sector being displayed. 
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General Infonnation 



Hew to Execute Zap Functions 

There are two ways to execute Zap functions: using the Zap function line 
and using single-keystroke ooinmands. Generally speaking, single- 
keystroke coinmands perform minor changes quickly, whereas the function 
line performs more substantial changes. The method you use depends on 
what is more convenient for you and on your terminal type (single- 
keystroke commands vary according to terminal type) . 



The Zap Function Line 

To call up the Zap function line, strike the escape key, [ESC] , 
twice. Ihe number 1 appears in parentheses at the bottom of the 
screen: 



iS>*««f5^i9ia!f*'?^»»5'."t'''*'*8''''*'*'l!/*'^PP* 



niDj^ j jp»y»»^ii»>yi i i^ f i ^M i jiyjHHHjsw 



iyi8»a'W%j'"'»*» •" TV 1 




eci»<i m«im«r mnut» m'm'm'r^, m.mmtKtmM% 

■'mtwikm'm>mmm^. 

m m.m. o^nTs at tai i: :.. ^ 

MHntdKdMt iM 
// /.. 




as $«0 ntm iaoor 




The bottom line of the screen, where the (1) appears, is the Zap 
function line. The number in parentheses represents the number of 
times this function will be repeated. It is called the function 
repetition number. 
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General Infonnation 



When you are on the Zap function line, type the two-letter mnemonic 
for the function you wish to execute. When you type the first 
letter of the innemonic, the following prompt appears in place of the 
(1) : 

Cmd> 

If the function requires no further input, it is executed 
immediately when you type the last letter of the mnononic. If the 
function requires additional information, such as a page number or a 
filename, a prompt for that information appears when you type the 
last letter of the mnemonic. For example, the sL function calls the 
following prompt to the function line: 

Zap File/Device name> 

Type the information requested by the prompt. Then to execute the 
function, strike either [RETON] or [ESC] [ESC] . On the Zap function 
line, [RETON] and [ESC] [ESC] are equivalent. 

If you enter the Zap function line and then decide not to perform a 
function, simply strike [ESC] [ESC] again, or strike [RETON] . You 
can also use the CANCEL command, [CTRL] c, to exit the function line 
at any time. That is, whether you are in the middle of typing a 
function or have just entered the function line, you can hold down 
the control key and type c to cancel the function line. 

In this manual. Zap function-line commands are referred to by escape 
key and mnemonic: for example, [ESC] [ESC] ef . 

Single-key stroke Commands 

Depending on the terminal type, certain Zap functions can be 
executed with a single keystroke, using either arrow keys, keypad 
keys, or control keys. 

For details on using the alternate keypad, see the VEW User's 
Reference Manual . In this manual, function keys on the alternate 
keypad are enclosed in curly braces: for example, {4}. 

To execute a control-key function, press the control key, [CTRL] , 
and hold it down while you type the character for the command. The 
function is executed immediately, unless other input is required. 
If the function requires additional information, a prompt appears on 
the function line. For example, to move the cursor to the top of a 
page, hold down [CTRL] and type h. The cursor moves immediately. 
Most control -key functions can be repeated by keeping the control 
key depressed and repetitively striking the character key. In this 
manual, control-key functions are referred to by control key and 
character: for example, [CTRL] h. 
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General Information 



Moving the Cursor 

The cursor can be positioned in either the hex field or the text field on 
the screen. The cursor cannot be positioned between the hexadecimal 
characters in the hex field. 

Use the arrow keys, the control key functions, and the function line 
commands to move the cursor. 

If the cursor is located on the top or bottom margin of the screen, and 
the arrow key (or equivalent function-line command) that would move the 
cursor toward that same margin is pressed, the cursor jumps to the 
opposite margin in the same column. For example, if the cursor is in the 
first column at the bottom margin of the hex field and you strike the 
down-arrow, the cursor moves to the first column at the top margin of the 
hex field. 

If the cursor is located on the right margin of the screen, pressing the 
right-arrow key moves the cursor to the left margin and down one line. 
If the cursor is on the bottom line, the cursor moves to the top line at 
the left margin. 

If the cursor is located on the left margin of the screen, pressing the 
left-arrow key moves the cursor to the right margin and up one line. If 
the cursor is on the top line, the cursor moves to the bottom line at the 
right margin. 

The arrow keys move the cursor from the hex field to the text field, but 
the word-movement function, jSKr remains within whichever field of the 
screen the cursor was in when the function was executed. In other words, 
the only ways to switch between fields are to use the left- and right- 
arrow keys or to use the sL and fl commands - 



Making Changes 

To change data in a file, whether the cursor is in the hex field or the 
text field, put the cursor on the character or digit you want to change 
and then type .the new character or digit. The new character replaces (is 
typed over) the old one. 
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General Infonnation 



Help Display 



To call up a list of Zap functions (a help display) , strike [ESC] [ESC] 
and type he. 

The help display is several pages, or screenfuls, long. Once you call it 
to the screen, press any key to see the next page. 

The help display is automatically exited after the last page is 
displayed. If you wish to exit the help display without viewing all the 
pages, type [ClMi] c. This returns you immediately to the file or device 
you were editing, and the cursor appears where it was before you called 
up the help display. 



Unknown Functions 

If you try to type on the Zap function line anything other than the 
mnemonics for the functions listed in this manual, a bell or beep sounds. 
The cursor remains on the function line. You can either type a 
recognized mnemonic or exit the function line. 



The Minus Sign 

Unless you specify otherwise, all Zap functions are performed toward the 
end of the file. However, the minus sign, -, can be used to perform some 
functions toward the beginning of the file. 

For example, if you type ml onto the function line, the cursor moves one 
line toward the end of the page. But if you type -ml onto the function 
line, the cursor moves one line toward the beginning of the page. When 
you type the minus sign, the (1) on the function line changes to (-1) . 



Restoring Deleted Material 

If you have modified or deleted the data in a page or sector and you wish 
to restore the page or sector to its original values, you can do so with 
the Undo function, M. Read the description of this function in the 
Dictionary of Zap Commands, Chapter 3 of this manual. 
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General Information 



Repeating and Editing the Function Line 

Use [CTRL] \ to recall the previous function line. You can then edit it 
or execute it again. See the YM LIssJLLa Reference Manual for details on 
editing the function line. 

Use [CTRL] z to execute the previous function without being able to edit 
it. For example, if the last function was the search function, 
[ESC] [ESC] sr, you could use [CTRL] z to find the next occurrence of the 
same string. 



File Versions 

When Zap is invoked on an existing file, a new version of the file is 
not created. If any modifications are made with Zap and actually written 
to the disk, (see the sa. and sL functions described in the Dictionary of 
Zap Functions, chapter 3 of this manual) , the changes are made in the 
original file. 



Diagnostic Messages 

If you make an error in the Zap Program, a diagnostic message like the 
following appears at the bottom of your screen: 

ZAP : Opening file.txt 

FAILED : Status =136. 

MESSA3E : The specified file is w rite-locked. 

The first line of the diagnostic message tells you the name of the 
program (ZAP) and wliat the program was doing when the problem occurred. 
The second line tells you the status of the process (FAILED) and the 
diagnostic number (136) . The third line is the message itself, explaining 
\fY^ the operation could not be completed. 
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General Infonnation 



If an error occurs that does not prohibit Zap from continuing execution, 
then the diagnostic message appears below the page number, as in the 
following example: 



xat xst XT X3t xxxtsatxx xxntxxxtt 



00000010 xx3ac3X3Qc xxxstxxxx aoexK 

00000020 xKscicxxxx xx xx xx xk xx xx 

000<%D030 XX XX Xt XX XX XX XX XX XX XX 

xxmxxxx xxxxtxxx "wtxx 

XX XX XX XX XB XX tX XX/ XX xx 
XX XX'XIX TKSt' 



XX XX 
XX XX 

XX XX 



XX 
XX 
XX 
XX 

XX 

XX 



XX XX 
XX XX 

XX XX 

xxxx 

XX XX 




XX *•<»«*.>»•»•«»•• 

XX *«*•««'•«*«'*««**«' 

XX it-m^m************ 

XS< #•*#«'*'•'«'»««•«««'* 



The process tried to read past the logical end of a file. 




A complete glossary of diagnostic messages appears in the MCS. User's 
Reference £^nual. 
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Chapter 2 
Directory of Zap Functions 



In this directory, the functions are grouped according to what you use 
them to do: move the cursor, calculate a checksum, etc. Control-key 
functions and other functions, such as the alternate keypad and the arrow 
keys, are listed next to their equivalent escape-key functions. See 
Chapter 3 for an alphabetical list of Zap's escape-key functions. That 
chapter explains step-by-step how to execute each function. 

The minus sign, -, in front of some of the escape-key functions means 
that this function is performed toward the beginning of the file. 

The character keys specified in this chapter as control -key functions and 
alternate keypad functions are default character keys for these functions 
on a WICAT T7000 terminal. Ihese character keys may differ according to 
your terminal type. If your terminal is not a T7000 or if you want to 
assign keys other than those specified here, see the VEW User's Reference 
Manual for further information. 
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Directory of Zap Functions 



Move the Cursor to: 

Escape-key 
Loc ati o n fu nctions 



Top of file [ESC] [ESC 

End of file [ESC] [ESC 

Next Sector [ESC] [ESC 

Previous sector [ESC] [ESC 

Next page [ESC] [ESC 

Previous page [ESC] [ESC 

Specific sector or page [ESC] [ESC 

Front of next line [ESC] [ESC 

Front of previous line [ESC] [ESC 

Same column of next line [ESC] [ESC 

Same column of previous line [ESC] [ESC 

Front of field on current line [ESC] [ESC 

End of field on current line [ESC] [ESC 

Next word [ESC] [ESC 

Previous word [ESC] [ESC 

Next cliaracter or byte [ESC] [ESC 

Previous ctiaracter or byte [ESC] [ESC 



mt 
me 

ms 

-ms 

irp 

-rrp 

go 

ml 
-ml 

Pl 
-pi 

fl 
el 

m/f 
-irw 

mc 
-mc 



Control-key 



[CTRL] t 
[CTRL] e 



[CTRL] p 

[CTRL] h 

[CTRL] X 

[CTRL] O 

[CTRL] w 



[CTRL] a 

[CTRL] g 

[CTRL] f 

[CTRL] r 



Other 
functions 



down-arrcw 
up-arrcw 



right-arrow 
left-arrow 



Gcsmpute a checksum for: 

Type Qt IlUqqJs. 

WMCS boot block 

Other (non-WMCS) boot block 

WMCS file control block (FCB) 



Escape-key 

[ESC] [ESC] be 

[ESC] [ESC] oc 

[ESC] [ESC] fc 



Control-key Other 
functions functions 



Copy 



Itan copig<3 



Page 
Sector 



Escape-key 
functions 

[ESC] [ESC] CO 
[ESC] [ESC] cs 



Control-key Other 
functions functions 
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Directory of Zap Functions 



Search 



A pplication 

Search (toward end of file) 
Search (toward top of file) 



Escape-key 
functions 

[ESC] [ESC] sr 
[ESC] [ESC] -sr 



Control-key 
functions 



Other 
functions 

{7} 
{4} 



Create a dP 

Application 
Create a CIP from Zap 



Escape-key 
functions 

[ESC] [ESC] cp 



Control-key Other 
functions functions 



IJhdo Changes 



Escape-key 
functions 



Application 
Undo changes to page or sector [ESC] [ESC] ud 



Control-key 
functions 



Other 
functions 

{PFD 



Create a Print-file of: 

Itsm printed 
Current page 



Escape-key 
functions 

[ESC] [ESC] pr 



Control-key Other 

functions 



Set to a Constant Value 



Item set 



Page 
Sector 



Escape-key 



[ESC] [ESC] sp 
[ESC] [ESC] ss 



Control-key Other 
functions functions 
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Directory of Zap Functions 



Screen Functions and Help Display 
;^pJLj.gat3.Qn 



Escape-key 
functions 



Refresh screen 
Help display 



[ESC] [ESC] rs 
[ESC] [ESC] he 



Control-key 



[CTRL] - 



Other 
functions 



File Control 



Application 



Escape-key 
functions 



Abort Zap, do not save changes [ESC] [ESC] ab 

Save changes [ESC] [ESC] sa 

Exit Zap and save changes [ESC] [ESC] ex 

Edit new file or device [ESC] [ESC] ef 



Control-key 
functions 



[CTRL] 



Other 
functions 



{-} 



Toggle Functions 

Application 
Toggle raaskSbit display flag 



Escape-key 
functions 

[ESC] [ESC] tm 



Control-key Other 
functions functions 



Repeat or Edit the Previous Escape-key Function 



Application 

Repeat last function 
Recall last function line 



Escape-key 
functions 

[ESC] [ESC] rp 



Control-key 



[CTRL] z 
[CTRL] \ 



Otlier 
functions 



Control-cheuracters on the Function Line 



Application 
Insert control-key character 



Escape-key 
functions 



Control-key 
functions 



Other 
functions 

{ENTER} 
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Directory of Zap Functions 

Terminate a Zap Function 

Escape-key Control-key Other 
Application functions functions functions 

Terminate Zap function [CTRL] c 
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Chapter 3 
Dictionary of Zap Functions 



This dictionary of escape-key functions is arranged alphabetically 
according to the mnemonics used to execute the functions. 

Control-key functions and alternate keypad functions are described under 
their corresponding escape-key functions. Alternate keypad functions are 
indicated by curly braces, {}. 
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Functional Description 



Use this function to abort the current editing session; that is, to exit 
the current file without making ar^ modifications. 



Execution 



Step 1 



Step 2 



Step 3 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type ab. 

If no modifications were made during this session of Zap, the 
file is immediately exited. 

If modifications were made to the file, this prompt appears 
at the bottom of your screei: 

File data has been modified - abort? 
If you were editing a device, this prompt appears: 

Device data has been modified - abort? 
Type y. 
This message appears at the bottom of your screen: 

Aborting. . . 

The screen is then cleared and the cursor appears on the CIP 
command line. 
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ab 



Notes on Usage 



If you type a charac±er other than y or n in response to the prompt, the 
following message appears momentarily: 

Please type 'Y' or 'N'. 

The prompt then reappears. 

Corresponding and Related Functions 

[ESC] [ESC] ex Exit file 
[ESC] [ESC] sa Save file 
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boot block checksum 



Functional Description 



Use this function to calculate the WMCS boot block checksum. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type be. 

The new checksum is calculated and placed in the last four 
bytes of the display. The cursor reappears in the same 
position it was in prior to the execution of J2£L. 



Notes on Usage 



The bs. function assumes the display is that of a disk boot block (disk 
boot blocks contain a checksum in the last four bytes) . 



Corresponding and Related Functions 



[ESC] [ESC] oc Calculate boot block checksum for other disks 
[ESC] [ESC] fc Calculate fcb checksum 
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copy 



Functional Description 



Use this function to copy a page from one part of the file or device to 
the curroit page. 



Execution 



For usage 
Step 1 



Step 2 



Step 3 



Step 4 



on a file: 

Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type CO. 

A proirpt like the following appears at the bottom of your 
screen: 

Copy Page> 

Type a page number- 

This is the number of the page you wish to copy to the 
current page. The number may be either a decimal or 
hexadecimal value. Decimal values must begin with a percent 
signf %. 

Strike [RETON] . 

The display refreshes as the current page is replaced by the 
copied page. The cursor reappears in the same position it 
was in prior to the execution of so.. 



co-1 



CO 



For usage 
Step 1 

Step 2 



Step 3 



Step 4 



Step 5 



Step 6 



on a device: 

Strike [ESC] [ESCJ . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type CO. 

A prompt like the following appears at the bottom of your 
screen: 

Copy Sector > 

Type a sector number. 

The number may be either a decimal or hexadecimal value. 
Decimal values must begin with a percent sign, % . 

For example, type 21. 

Strike [RETON] . 

An additional prompt like the following appears at the bottom 
of your screen: 

Copy Sector > 21 Page> 

Tyipe a page number. 

TJiis is the number of the page you wish to copy to the 
current page. The number may be either a decimal or 
hexadecimal value. Decimal values must begin with a percent 
sign, % . 

The valid range of page numbers on a disk device is 
determined by the sector size of the disk, divided by 256. 
For example, type either or 1 for disks with 512-byte 
sectors, or type a number in the range 0-3 for disks with 
1024-byte sectors. 

Strike [RETON] . 

•Hie display refreshes as the current page is replaced by the 
copied page. The cursor reappears in the same position it 
was in prior to the execution of so.. 
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CO 



Itotes on Usage 



If the page you specify is beyond the end of the file, the following 
message is briefly displayed: 



The specified page is beyond the end of the file. 



Corresponding and Related Functions 



[ESC] [ESC] cs Copy sector 
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cip 



Functional Description 



Use this function to go temporarily to the Command Interpreter Program 
(CIP) without losing your place in the file or closing or updating the 
file. 



Execution 



Step 1 



Step 2 



Step 3 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type cp. 

The CIP prompt appears. 

When you want to return to Zap, execute the CIP command log . 
See the WMCS User ' s Reference Manual for a complete 
explanation of the log command. 

When you return to Zap, the cursor reappears in the. same 
position it was in prior to the execution of £j2. 



Notes on Usage 



None. 
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cp 



Corresponding and Related Functions 



[ESC] c Create a CIP 



cp-2 




copy sector 



Functional Description 



Use this function to copy a sector from one part of the file or device to 
the curreit sector. 



Execution 



Step 1 



Step 2 



Step 3 



Step , 4 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type OS. 

The follo/ing pranpt appears on the function line: 

Copy Sector > 

Type the number of the sector you wish to copy to the current 
sector. 

Ihe number may be either a decimal or hexadecimal value. 
Decimal values must begin with a percent sign, %. 

Strike [RETIRN] . 

The display refreshes, shewing the contents of the newly 
copied sector. The cursor reappears in the same position it 
was in prior to the execution of ££. 
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cs 



Itotes on Usage 



If the sector you specify in step 3 is beyond the end of the file, the 
following message is briefly displayed: 

The specified sector is beyond the end of the file. 

A sector is the same size as a page when you are editing a file; that is, 
cs functions the same as £0. when you are editing a file. 



Corresponding and Related Functions 



[ESC] [ESC] CO Copy page 
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edit file 



Functional Description 



Use this function to edit a new file without exiting Zap. 



Execution 



Step 1 



Step 2 



Step 3 



Strike [ESCl [ESCl . 

The number 1 aj^ars at the bottom of your screen on the Zap 
function line. 

Type ef . 

A prompt like this appears at the bottom of your screen: 

Zap File/Device name> FILE. TOT 

The cursor aj^ars on the first letter of the filename you 
are now editingr FILE.IOT in the example above. 

T^pe a filenamCf or a c3evicename preceded by an underscore. 
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e£ 

Step 4 



Step 5 



Strike [REDRN] . 

If you have wL modified any data in the current file, the 
current file is aborted and the new file you specified 
appears on the screen. 

If you have made any modifications to the file you are 
currently editing, the following message appears at the 
bottom of your screen: 

File data has been modified - save? 

Or if you have made modifications to the device you are 
editing, this message appears: 

Device data has been modified - save? 

When one of the foregoing messages appears, go to step 5. 

If you want to save your modifications, type y. If you do 
not want to save them, type n. 

If you type y, the current file modifications are saved, and 
then the new file appears on the screen. 

If you type n, the current file is aborted, and the new file 
appears on the screen. 

Should you respond with any character other than y or n, the 
following message appears briefly on your screen: 

Please type 'Y' or 'N'. 

Ihen the message from step 4 reappears on the screen. 



Notes on Usage 



If the new file does not exist, it is created. 



Corresponding and Related Functions 



[CTRL] 



Edit another file or device 
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end of line 



Functional Description 



Use this function to move the cursor to the end of the current line in 
either the hex or the text field, or to change fields on the current 
line. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESa . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type el. 

The cursor moves to the end of the current field. If it is 
already at the end of a field, the cursor moves to the front 
of the other field on the line. 



Notes on Usage 



None. 



Corresponding and Related Functions 



[CTE^] g Move cursor to end of line 

[ESC] [ESC] fl Move cursor to front of line 
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exit 



Functional Description 

Use this function to exit the file you are editing and simultaneously 
save any modifications you have made. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

Tlie number 1 appears at the bottom of your screen on the Zap 
function line. 

Type ex. 

This kind of message appears at the bottom of your screen: 

Exiting FILE. TXT 

Then the screen is cleared and the cursor appears next to the 
dP prompt (right angle bracket) on the dP command line. 



Notes on Usage 



None. 
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ex 



Corresponding and Related Functions 



{-} Exit file 

[ESC] [ESC] ab Abort file 

[ESC] [ESC] sa Save modifications to file 
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fcb checksum 



Functional Description 



Use this function to calculate the FCB checksum. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type fc. 

The new checksum is calculated and placed in the last two 
bytes of the display. The cursor reappears in the same 
position it was in prior to the execution of ic. 



Notes on Usage 



^e fc function assumes the display is that of an FCB entry in the file 
named /ROQIDIP/FCB.SYS (FCB entries contain a checksum in the last two 
bytes) . 



Corresponding and Related Functions 



[ESC] [ESC] be Calculate boot block checksum for WMCS disks 
[ESC] [ESC] oc Calculate boot block checksum for other disks 
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front of line 



Functional Description 



Use this function to move the cursor to the front of the current line in 
either the hex or the text fieldr or to change fields on the current 
line. 



Execution 



Step 1 



Step 2 



Strike CESC] [ESC] . 

•Hie number 1 appears at the bottom of your screen on the Zap 
function line. 

Type fl. 

Ihe cursor moves to the front of the current field. If it is 
already at the front of the field, the cursor moves to the 
end of the other field on the line. 



Notes on Usage 



None. 
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Corresponding and Related Functions 



[CTRL] a Hove cursor to front of line 
[ESC] [ESC] el Move cursor to end of line 
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go to sector/page 



Functional Description 



Use this function to go to a specific page number in a file, or to a 
specific sector and page number on a device. 



Execution 



For usage 
Step 1 

Step 2 



Step 3 



Step 4 



on a file: 

Strike [ESC] [ESC] . 

•nie number 1 appears at the bottom of your screen on the Zap 
function line. 

Type go. 

A prompt like the following appears at the bottom of your 
screen: 

Go to Page> 

Type a page number. 

The number may be either a decimal or hexadecimal value. 
Decimal values must begin with a percent sign, %. 

Strike [RE3KN] . 

The screen is repainted with the new page of data. 
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go 



For usage 
Step 1 

Step 2 



Step 3 



Step 4 



Step 5 



Step 6 



on a device: 

Strike [ESC] [ESC] . 

The number 1 appears at tlie bottom of your screen on the Zap 
function line. 

Type go. 

A prompt like the following appears at the bottom of your 
screen: 

Go to Sector > 

Type a sector number. 

The number may be either a c3ecimal or hexadecimal value. 
Decimal values must begin with a percent sign, %. 

For example, type 21. 

Strike [REIRN] . 

An additional prompt like the following appears at the bottom 
of your screen: 

Go to Sector > 21 Page> 

Type a page number. 

The valid range of page numbers on a disk device is 
determined by the sector size of the disk, divided by 256. 
For example, type either or 1 for disks with 512-byte 
sectors, or type a number in the range 0-3 for disks with 
1024-byte sectors. 

Strike [REIKN] . 

The screen is repainted with the new page of data. 
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go 



tfotes on Usage 



If you type a number that is not in the valid range for the given device, 
a message like the following appears briefly at the bottom of your 
screen: 

The page number number must be between and 0003. 

Then the cursor returns to the place on the current page where it was 
before the 30. function was initiated. 



Corresponding and Related Functions 



[CTE^] X Move to specific page or sector 
[ESC] [ESC] me Move to end of file or device 
[ESC] [ESC] mt Move to top of file or device 
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Functional Description 



Use this function to display the help screens for Zap, 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type he. 

The c3ata on the screen are erased, and the first screen of 
the help display is shewn. Near the bottom of the screen the 
following prompt appears: 



Press any key to continue 



... 



There are several pages in the help display. After the last 
page is displayed, the data from the current page is 
redisplayed, and the cursor reappears in the same position it 
was in prior to the execution of M. 



Notes on Usage 



You may exit the help display without going through all the pages by 
typing [CTRL] c. 



he-1 



he 

Corresponding and Related Functions 
None. 
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mc 



move character 



Functional Description 



Use this function to move the cursor one character forward or backward. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type mc to move the cursor to the next hex position (if the 
cursor is in the hex field) or to the next text position (if 
the cursor is in the text field) , or type -mc to move the 
cursor to the previous hex or text position. 

If the cursor is in the last text position on a line when you 
execute Mi, it jumps to the first hex position on the next 
line. If the cursor is in the last text position on the last 
line of the screen, it moves to the first hex position on the 
first line of the screen. If the cursor is in the last hex 
position on a line, it moves to the first text position on 
the same line. 

If the cursor is in the first hex position on a line when you 
execute -mc > it jumps to the last text position on the 
previous line. If the cursor is in the first hex position on 
the first line of the screen, it moves to the last text 
position on the last line of the screen. If the cursor is in 
the first text position on a line, it moves to the last hex 
position on the same line. 
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mc 



Notes on Usage 



None. 



Corresponding and Related Functions 



right-arrcw Move cursor to next character 
left-arrcw Move cursor to previous character 
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me 



move to end 



Functional Description 



Use this function to move the cursor to the end of the current file or 
device. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type me. 

The cursor moves to the last position in the hex field on the 
last page (if the cursor is in the hex field) , or to the last 
position in the text field on the last page (if the cursor is 
in the text field) . 



Notes on Usage 



None. 



Corresponding and Related Functions 



[CTRL] e 
[ESC] [ESC] mt 



Move to end of current file or device 
Move to top of current file or device 
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move line 



Functional Description 



Use this function to move the cursor to the front of the next or previous 
line. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

Tlie number 1 appears at the bottom of your screen on the Zap 
function line. 

Type ml to move the cursor to the front of the next line in 
the same field, or type -nil to move the cursor to the front 
of the previous line in the same field. 

If the cursor is on the last line of the screen (in either 
field) when you type ml, the cursor moves to the front of the 
first line. 

If the cursor is on the first line of the screen (in either 
field) when you type -ml, the cursor moves to the front of 
the last line. 



Notes on Usage 



None. 



ml-1 



ml 



Corresponding and Related Functions 



[CTRL] o Move cursor to front of next line 

[CTRL] w Move cursor to front of previous line 

[ESC] [ESC] pi Move cursor up or down a line in same column 
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move page 



Functional Description 



Use this function to page forward or backward through the file, 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type np to move to the next pager or type -mp to move to the 
previous page. 

If the cursor is not on the last line of the display when you 
type mp, it moves to the last line. Chce the cursor is on 
the last line, n© refreshes the screen with the next page of 
data. The cursor reappears in the last position of the hex 
field (if it was in the hex field when you executed mp) or in 
the last position of the text field (if it was in the text 
field when you executed mp) . 

If the cursor is not on the first line of the display when 
you type -mp, it moves to the first line. Once the cursor is 
on the first line, -irp refreshes the screen with the previous 
page of data. The cursor appears in the first position of 
the hex field or the first position of the text field, 
whichever it was in before you executed zJHp. 
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np 



Notes on Usage 



None. 



Corresponding and Related Functions 



[CEE^] p Move cursor to next page 

[CTRL] h Move cursor to previous page 

[ESC] [ESC] go Go to a specific page 

[ESC] [ESC] ms Move to ttie next or previous sector of file or device 
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ms 



move sector 



Functional Description 



Use this function to move to the next (or previous) sector on a device. 



Execution 



Step 1 



Step 2 



Strike [ESC] CESa . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

lype ms to move the cursor to the next sector, or type -ms to 
move the cursor to the previous sector. 

The screen is refreshed with the next (or previous) sector of 
data. The cursor reappears in the same position it had on the 
page from which it was moved. 



Notes on Usage 



Tliis function applies to devices only. If executed on a file, it has the 
same effect as the mp function. 

The ma function always moves to page within the specified sector, 
regardless of the page you are on when you execute jus.. 
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Corresponding and Related Functions 



[ESC] [ESC] go Go to a particular page 

[ESC] [ESC] me Move to tlie last page of the file or device 

[ESC] [ESC] mp Move to ttie next or previous page of the file or device 

[ESC] [ESC] mt Move to the the first page of the file or device 
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move to top 



Functional Description 



Use this function to move the cursor to the top of the file or c3evice. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type mt. 

The cursor moves to the first position in the hex field on 
the first page (if the cursor is in the hex field), or the 
first position in the text field on the first page (if the 
cursor is in the text field) . 



Notes on Usage 



None. 



Corresponding and Related Functions 



[CTE^] t Move to top of file or device 

[ESC] [ESC] me Move to end of file or device 
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move word 



Functional Description 



Use this function to move the cursor to the beginning of the next word or 
to the end of the previous word. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom 
function line. 



of your screen on the Zap 



Type nw to move the cursor to the beginning of the next word, 
or type -nw to move the cursor to the end of the previous 
word. 

If the cursor is at the last word on a line when you type nwr 
it moves to the first word on the next line. If the cursor 
is at the last word on the last line, it moves to the first 
word on the first line. 

If the cursor is at the first word on the line when you type 
-nWf it moves to the last word on the previous line. If the 



cursor is at the first word on 
the last word on the last line. 



the first line, it moves to 



Notes on Usage 



Ihis function considers alphanumeric characters as words in the text 
field. In the hex field, this function moves from byte to byte. 
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nw 



Corresponding and Related Functions 



[CIKL] f Move cursor to next word 
[CTRL] r Move cursor to previous word 
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other checksum 



Functional Description 



Use this function to calculate the checksum for other (non-WMCS) boot 
blocks. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type oc. 

The new checksum is calculated and placed in the last four 
bytes of the display. The cursor reappears in the same 
position it was in prior to the execution of ixi- 



Notes on Usage 



The as. function assumes the display is that of a disk boot block for an 
operating system other than WMCS, e.g., for UNIX (disk boot blocks 
contain a checksum in the last four bytes) . 
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oc 



Corresponding and Related Functions 



[ESC] [ESC] be Calculate boot block checksum for WMCS disks 
[ESC] [ESC] fc Calculate fcb checksum 
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position in line 



Functional Description 



Use this function to move the cursor up or down a line in the same 
column. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

TYpe pi to move the cursor down a line on the screen, or type 
-pi to move the cursor up a line. 

If the cursor is on the last line when you type pi, it moves 
to the same column on the first line. 

If the cursor is on the first line when you type -pi, it 
moves to the same column on the last line. 



Notes on Usage 



None. 
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pi 



Corresponding and Related Functions 



up-arrcw Move cursor up a line 

down-arrcw Move cursor down a line 

[ESC] [ESC] ml Move cursor to front of next or previous line 
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print 



Functional Description 



Use this function to create a print file of the current page. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type pr. 

TJie following message appears briefly at the bottom of the 
screen: 

Printing page... 



Notes on Usage 



Zap creates in the current directory a new file named ZAP.EE^, which is a 

copy of the data on the screen at the time the pr. function is executed. A 

time stamp is appended to the end of the file. You can print ZAP.PRN 
with the dP command piint. 
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Corresponding and Related Functions 
^Jone. 
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repeat function 



Functional Description 



Use this function to repeat the last function you executed. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type rp. 

The last function you initiated from the Zap function line is 
executed. 



Notes on Usage 



If no previous function exists, a bell or beep is sounded. 



Corresponding and Related Functions 



[CTRL] z 
[CTRL] \ 



Repeat the last function 
Recall the last function line 
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refresh screen 



Functional Description 



Use this function to redisplay (refresh) the screen. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type rs. 

The screen is redisplayed, and the cursor returns to the 
position it had prior to the xa function. 



Notes on Usage 



Use xa to restore the display on the screen when the display is jumbled. 
For example, when a user sends you a message and you are in Zap, that 
message appears on your screen and disrupts the display. The is. function 
restores the display to its condition before the interruption and returns 
the cursor to its original position. 



Corresponding and Related Functions 



[CTRL] - 



Redisplay the screen 
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save changes 



Functional Description 



Use this function to save all the modifications made to the file or 
device so far. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type sa. 

The following message is briefly displayed at the bottom of 
your screen: 

Saving modifications. . . 

^e cursor returns to the position it had prior to the .^i 
function. 



Notes on Usage 



Use sa to periodically save modifications to a file or device, if you are 
certain that you want the changes made and that you will not be exiting 
Zap shortly. Ihis makes it possible to save the work you have done so 
that in case the machine crashes, the modifications made prior to the 
last save will have been written to the disk. 

If no modifications have been made, this function has no effect. 
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sa 



Corresponding and Related Functions 



{,} Save iiKxiifications 

[ESC] [ESC] ab Abort file 
[ESC] [ESC] ex Exit Zap 
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set page 



Functional Description 



Use this function to set the page to a constant value. 



Execution 



Step 1 



Step 2 



Step 3 



Step 4 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

TTpe sp. 

A prompt like the following appears at the bottom of your 
screen: 

Set Page to Constant> 

Type a number. 

•Hie number may be eithier a decimal or hexadecimal value. 
Decimal values must begin with a percent sign, %. 

For example if you type 9E in response to the prompt, the 
entire page (or to the end of the valid data on the page) 
will be set to the hex pattern 9E. 

The cursor returns to the place on the page where it was 
before the function was issued. 
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sp 



Notes on Usage 



None. 



Corresponding and Related Functions 



[ESC] [ESC] ss Set sector to constant 
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search 



Functional Description 



Use this function to search for a hexadecimal or character string. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type sr to search forward through the file, or type -sr to 
search backward. 

If you type sr, a prompt like the following appears at the 
bottom of your screen: 

Search EVd> 

If you type -sr, the following prompt appears at the bottom 
of your screen: 

Search Bwd> 
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sr 



step 3 



Step 4 



Type the string to be searched for. 

You can enter the string in hexadecinal bytes, 
you could type the following: 

4e 75 4e 5a ff fc 



For example f 



Or you can enter the string in text characters. When you 
search for text characters, they must be enclosed in either 
single or double quotation marks. For example, you could 
type the following: 

"find this string" 



NOTE: You must enclose the character string in identical 
quotation marks. That is, do not begin the string with 
a single quotation mark and end it with a double 
quotation mark, or vice versa. 



Strike [REIKN] . 

Zap begins searching for the string. If the string is found, 
the cursor reappears at the end of the string, in whichever 
field the cursor was in when you executed sjn. 

If the string is not found, the following message appears 
briefly at the bottom of the screen: 

Search argument not found. 

The cursor then returns to the point where it was prior to 
the execution of the sc function. 



Notes on Usage 



If you don't enter any data on the function line, or if you enter invalid 
data when the cursor is in the hex field, one of the following error 
messages appears briefly at the bottom of the screen: 

The search argument must have at least one byte of data to search 

for. 

An invalid character appears in a decimal string. 

No number was found during a search or scan for a number. 
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sr 



Corresponding and Related Functions 



{7} Search forward 

{4} Search backward 



sr-3 




set sector 



Functional Description 



Use this function to set the sector to a constant value. 



Execution 



Step 1 



Step 2 



Step 3 



Step 4 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type ss. 

A prompt like the following appears at the bottom of your 
screen: 

Set Sector to Constant> 

Type a number. 

The number may be either a decimal or hexadecimal value. 
Decinal values must begin with a percent sign, %. 

For example if you type 9E in response to the prompt, the 
entire sector (or to the end of the valid data in the sector) 
will be set to the hex pattern 9E. 

The cursor returns to the place on the page where it was 
before the function was executed. 
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ss 



Notes on Usage 



None. 



Corresponding and Related Functions 



[ESC] [ESC] sp Set page to constant 
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toggle maskSbit 



Functional Description 



Use this function to enable or disable display of characters with bit 8 
set. 



Execution 



Step 1 



Step 2 



Strike [ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type tm. 

Hie screen is updated to reflect any changes in the ASCII 
section (text field) of the display based on the state of the 
maskSbit flag, and the cursor returns to the position it had 
prior to the im function. 



Notes on Usage 



Normally, Zap does not display characters with bit 8 set, since these 
characters are outside of the ASCII character set which is defined for 
characters whose values range from to 127 ( $0 to $7F) . The im function 
toggles the state of the mask8bit flag. By default, the flag is not set 
and these characters are not displayed. The state of this flag can be 
affected by the tmaskSbit command-line switch and by the im function. 
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Corresponding and Related Functions 
None. 
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undo changes 



Functional Description 



Use this function to undo changes, 



Execution 



Step 1 



Step 2 



Strike C ESC] [ESC] . 

The number 1 appears at the bottom of your screen on the Zap 
function line. 

Type ud. 

The screen is redisplayed, shewing the data that was 
originally in the file (or sector on the device) , and the 
cursor returns to the position it had prior to the M 
function. 



Notes on Usage 



This function affects all changes made to a particular page or sector, 
even if you have left that page or sector and returned again to make 
modifications any number of times, (unless you have saved the 
modifications explicitly with the sa. function, or unless Zap requested a 
confirmation of a save because there were no more buffers to hold 
modified data) . 
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Corresponding and Related Functions 



(PFl) (on a T7000) Undo changes 

{PFO} (on a VISUAL200) Undo changes 
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